v7.16.0: released

Compare Source

v7.16.0 stable release comes with 100+ enhancements, bug fixes. Once again thanks for all the contributions from the community.

The community also contributed 3 new generators in this release:

• [python] add async httpx support Client: Python #​22021
• feat: Add Java Dubbo code generator for Apache Dubbo microservices #​21968
• New generator for Scala3 + sttp4 + jsoniter-scala #​21908

Below are the highlights of the changes. For a full list of changes, please refer to the "Pull Request" tab.

General

• Update commons related dependencies to newer versions #​21980
• Correctly annotate Gradle task in- & outputs and enable stricter plugin validation #​21957
• Support normalizing anyof/oneof enum constraints to a single enum #​21917
• feat: add support for minimal-update option in maven plugin #​21872
• Update swagger parser to 2.1.32 #​21818
• Fix bug in ModelUtils.getParentName resulting in wrong inner Models for oneOf-composed schemas #​21799
• [3.1] Fixed lack of check for booleanSchemaValue #​21742

Bash

• [bash] Drop old client.sh from petstore sample #​21987
• [bash] Fix issue where paste command doesn't work on Mac #​21986

C#

• Fix visibility for enum in C# generator #​21984
• [C#] Fixes array TypeDeclaration parsing order to fix deep aliases #​21600

Dart

• [dart-dio][timemachine] Bugfix: saving offset_date_serializer instead of local_date_serialize #​21974
• Add skipCopyWith option for dart-dio #​21816

Kotlin

• fix(kotlin-spring): add missing constructor parentheses for hashmap models #​22029
• [kotlin] Fix enum defaultValue in query parameters with schema reference #​22002
• [kotlin][client] remove old deprecated apis #​21988
• [kotlin-spring][server] Feat: Allow implementation of arbitrary interface in DTOs (similar to x-implements from java-spring) #​21950
• Fix missing @​Serializable on enums for kotlin/jvm-retrofit2 #​21907
• [kotlin-client] Fix string comparison in discriminator post-processing #​21881
• [kotlin-client] update Kotlin and libraries versions #​21866
• Kotlin Multiplatform polymorphism with custom discriminator support #​21772

Go

• go: Fix missing imports for optional body params #​22014
• feat(golang): support for wrapped and xml name #​21899

Java

• [JAVA] Add vendorExtensions.x-class-extra-annotation to oneOf interfaces #​22020
• [cxf] add support for Swagger2 #​22010
• [java] Fix annotationLibrary option being ignored #​21992
• [Java] [Spring-client] Exclude discriminator from nullable annotation #​21981
• feat: Add Java Dubbo code generator for Apache Dubbo microservices #​21968
• [jaxrs-spec][quarkus] Feat: Add an option to use "org.jboss.resteasy.reactive.RestResponse" #​21877
• [Java] [Spring] Use deduction configOptions for oneOfInterfaces #​20919

OCaml

• [Fix][OCaml] Incorrect encoding/decoding for required free-form objects; Odoc for record fields #​21819
• [OCaml] Generate .ocamlformat file; format all generated OCaml files #​21809
• [OCaml] Introduce support for oneOf/anyOf, fix default value for non-required maps #​21798

PHP

• Fix php-slim4 API key authentication throwing exception #​21962
• Setup void type for PHP Symfony CompilerpassInterface #​21808
• [php] Fixed typing of offsetGet/offsetSet/offsetUnset #​21583

ProtoBuf

• [protobuf] fix generation of enums with UNSPECIFIED values #​21774

Python

• [python] add async httpx (new library option) support #​22021
• [python] api client type checks #​21935
• fix(python): update pyproject.toml license format with poetry1 fallback #​21931
• [python] fix default value when enum is a reference #​21923
• python: feature flag for lazy imports #​21885

Ruby

• fix(ruby-client): Fix incorrect boolean parsing in OneOf/AnyOf #​21943

Rust

• [Rust-Axum] Support AnyOf, AllOf #​21948
• [Rust] Add support for native-tls and rustls-tls Cargo features for the reqwest library #​21925
• [BUG][rust-axum] Fix duplicate route operations when supplying multiple tags on a path with a camelCase param #​21873
• [rust] set useAsyncFileStream only for files in the body #​21839

Scala

• Mark scala-lagom-server as deprecated #​21977
• New generator for Scala3 + sttp4 + jsoniter-scala #​21908

Swift

• [Swift6][client]Make Swift 6 generator stable #​21846

TypeScript

• [typescript-axios]: withSeparateModelsAndApi handles importFileExtension #​22032
• [Typescript] add missing typeRoots config on tsconfig #​21824
• typescript-fetch: Fix model date crash #​21821

v7.15.0: released

Compare Source

v7.15.0 stable release (breaking changes with fallbacks) comes with 140+ enhancements, bug fixes. Once again thanks for all the contributions from the community.

This release comes with 1 breaking change (with fallback):

• [rust-server] Update to hyper1 in rust-server generator #​21422

The community also contributed 3 new generators in this release:

• [C++] [Client] Added cpp-oatpp-client #​21711
• Add cpp-oatpp-server generator (alpha) #​21547
• NestJS server codegen #​21494

Below are the highlights of the changes. For a full list of changes, please refer to the "Pull Request" tab.

General

• Bugfix for remote specs with params #​21634
• [gradle-plugin] add treatWarningsAsErrors option to openApiValidate in gradle plugin #​21626
• Fix response model generation with ParseOptions.resolveResponses=true #​21568
• [req] Allow models and apis list properties to span multi-lines #​21536
• Bump jmustache 1.15 -> 1.16 #​21352
• Add 'isFormStyle', 'isSpaceDelimited', and 'isPipeDelimited' flags to CodegenParameter #​21240
• Added symlink to generator CLI in Docker image #​15559

C

• add curl handler pre-invoke-callback to c-libcurl #​21654
• feature: Add control flag for static compile #​21635
• Add verbose, keepalive, keepidle, keepintvl to c-libcurl #​21613

C#

• [REQ] [CSHARP] [UNITYWEBREQUEST] Support Stream for unityWebRequest library #​21704
• [BUG][CSHARP][GENERICHOST] Write enum values in expected JSON format #​21698
• [csharp] Fix composed enum handling #​21690
• [csharp][generichost] Fix response testing when dataType missing #​21687
• [csharp] Ensure unique property names #​21649
• [csharp] Handle nested maps recursively #​21636
• [C++] [Client] Added cpp-oatpp-client generator #​21711

C++

• [C++] [Client] Added cpp-oatpp-client generator #​21711
• [C++] [Client] Fixes to cpp-oatpp-server generator #​21595
• Add cpp-oatpp-server generator (alpha) #​21547

Dart

• Feat: #​21665 [dart][dart-dio] CopyWith for json_serializable #​21667
• [dart-dio] Fix json_serializable response for type:string format:binary #​21379
• [dart-dio] Fix compile error in enum properties with "default" values (#​20495) #​21355

Go

• Update AWS Go SDK from v1 to v2 in Go client templates #​21653

Java

• [Java][RestClient] Generate servers for restclient library #​21699
• [spring] Adapt HttpHeaders access to remain compatible with Spring 7 #​21691
• [JAVA] Remove [this-escape] warnings in generated ApiClient classes #​21620
• [Java-Spring] add comment to EnumConverterConfiguration mustache file #​21598
• Conditional import of AtomicInteger added to delegate template #​21597
• [Java] [SpringClient] Introduce setting for sealed oneOf interfaces for Spring clients #​21586
• [okhttp-gson] Type check of array element only when array is not empty #​21571
• [Bug][java-spring] Use Flux only for multipart-form-data file parameters with multiple file uploads #​21561
• [Java][native] Add ability to add header to specific calls #​21495
• Move the singleRequestParameter template into a separate file #​21489
• [Java][MicroProfile] Support additionalProperties with Jackson #​21451
• Restricted Java oneOf imports to Jackson only when needed (#​21404) #​21405
• [JavaSpring] Allow configuring generic ResponseEntity for Spring generator #​21387
• [java][Microprofile] add config options to disable usage of ApiExceptionMapper #​20762

Kotlin

• [REQ] [CSHARP] [UNITYWEBREQUEST] Support Stream for unityWebRequest library #​21704
• kotlin-spring: fix exception thrown in enum.forValue #​21622
• [Bug][kotlin-spring] add a Spring type converter for enum values #​21579
• Kotlinx polymorphism with custom discriminator support #​21531
• [BUG][Kotlin] Fixed primitive type check for array of array #​21500
• [BUG][kotlin-spring] Fix Boolean type mismatch for kotlin-spring generator (#​21478) #​21481
• [BUG][Kotlin] fix: kotlin code generator should sanitize enum values according to convention #​21459

OCaml

• [OCaml] Derive eq #​21679

PHP

• [php][php-nextgen] add new github workflow to perform syntax check on php files #​21678
• [php] Fix file uploads (by backporting #​21458) #​21632
• fix: Use correct constructor for ApiException in PSR-18 PHP library #​21631
• Removed try/catch to enable framework error handling to pick up error #​21523
• php-nextgen - Fix flatten() to support arrays of files #​21458

Protobuf

• [Protobuf] Fix nullpointer for allOf with additionalProperties=false #​21556

Python

• python: Reinstate lazy imports #​21486

R

• [R] add null checks to nullable api parameters #​21629

Rust

• [Rust] Replace more HeaderValue::from_str with compile time from_static #​21689
• Add reqwest-trait crate to workspace and rename it #​21674
• Fixup failing CI in rust-server due to xmltree dependency #​21664
• [rust] Extend oneOf array enum names with inner type #​21599
• [Rust-Axum] Basic Authorization - Basic Analytic - XSS Sanitize #​21578
• Replace periods with underscores in Rust model names #​21480
• [rust-server] Update to hyper1 in rust-server generator (Breaking change (with fallback)) #​21422

Scala

• [Scala sttp] Fix header serialization for Optional values #​21603
• Generators "scala-sttp" and "scala-sttp4" produce valid code when using APIKeyQuery, APIKeyHeader and APIKeyCookie #​21551
• [scala][http4s] fix escaping of reserved words for correct model property names #​21518
• [scala][http4s] fix codegen for using reserved words in openapi #​21490

Swift

• [swift] [urlsession] Fixes crash for uploads with content-type "image/" #​21544
• [Swift5][Swift6] support "x-enum-descriptions" #​21706

TypeScript

• feat(typescript-angular): prepare build #​21684
• [BUG][typescript-fetch] Default case for oneOf serialization method returning undefined variable. #​21669
• [Bug][typescript-fetch] Typescript fetch one of addtl props imports #​21656
• [Bug][typescript-fetch] Fix missing close parenthesis in oneOf models #​21645
• [test][typescript-fetch] Add / improve unit tests for current typescript-fetch oneOf logic #​21638
• [typescript] Add optional erasable syntax configuration to Typescript generator #​21560
• [Typescript Fetch] Fix missing closing bracket in date handling #​21549
• Followup fix for importFileExtension config for typescript-axios #​21541
• NestJS server codegen (new generator) #​21494
• Fix typescript-fetch missing imports for oneof field with discriminator #​21477
• [typescript] Utility types now considered when generating schemas #​21414

v7.14.0: released

v7.14.0 stable release (breaking changes with fallbacks) comes with 110+ enhancements, bug fixes. Once again thanks for all the contributions from the community.

This release comes with 1 breaking change (with fallback):

• [GO] Go Server: Adds ordered routes to go-server router #​21280

Below are the highlights of the changes. For a full list of changes, please refer to the "Pull Request" tab.

General

• [gradle-plugin] Fix openapiGeneratorIgnoreList option #​21363
• Better handling of metadata in allOf #​21342
• Update swagger parser to 2.1.28 #​21325
• Fix broken build on Windows OS if the schema contains references to other schema files #​21300
• CodegenOperation & CodegenProperty: turn fields into getters #​21225
• fix: fix dev container failing to build #​21218
• Remove duplicate oneOf schemas during pre-processing #​21174

C#

• [csharp][generichost] Removed duplicate service registration #​21395
• [csharp][generichost] Updated docs #​21357
• [csharp][generichost] Fixed token availablity #​21326
• [csharp] Add missing ConfigureAwait(false) for csharp generator #​21244
• [csharp] Ignore date length validation #​21217

C++

• [cpp-restsdk] store Object as a shared pointer #​21349
• [cpp-restsdk] link cpprest without crypto libraries #​21348
• [cpp-rest-sdk] support serializing model base as parameters #​21235
• [cpp-rest-sdk] fix enum values being used instead of names #​21223
• fix(cpp-qt-client): add asJsonObject method to OAIEnum class (#​19307) #​21211

Elixir

• [chore][elixir] update dependencies #​21210
• [fix][elixir] simplify connection module #​21158

Go

• [GO] Go Server: Adds ordered routes to go-server router (Breaking change (with fallback)) #​21280

Java

• [Java] Fix content for enum in MultiPart #​21428
• [Java][RestTemplate] Gradle Build include non-compatible Spring Dependency with jakarta disabled #​21426
• [Java][vertx] fix path param encoding #​21403
• [jaxrs-spec][quarkus] fix cookie in param #​21400
• feat (JAVA NATIVE): add support for useSingleRequestParameter to java native client #​21331
• [JAVA] Correct generation of schema default values of type object #​21278
• Add option to set container's default to empty container #​21269
• Java: Optimize HashSet Initialization #​21205
• [JavaSpring][21200] improve Kotlin interopability with optional values #​21202
• adjust (sync) jersey2/jersey3 templates #​21171

Kotlin

• [kotlin] Fix compile error in enum properties with "" values(#​18660) #​21416
• Fix MiskKotlin OpenApiGenerator types #​21390
• avoid intersection type in kotlin-client template with jvm-okhttp4 engine #​21378
• [kotlin-client][multiplatform] update Kotlin and libraries versions #​21353
• [Kotlin] Primitive array items validity check #​21315
• Kotlin Misk Add Extra Parameters #​21271
• [kotlin-spring] fix validation regression in kotlin-spring generator #​21255
• [kotlin-client] Add support for integer enums in serialization step #​21248
• Improve Kotlin Misk OpenApi Generator #​21165

Nim

• [Nim] Fix compilation in case of schema with enum constraint with an enum value being not a valid nim identifier #​20780

Python

• [python] Validate pyproject.toml and fix the pyproject.toml version constraint format #​21402
• Replace periods with 'DOT' in Python enum member names #​21372
• fix(python-fastapi): remove 200 fallback code and use default (#​12481) #​21333
• [python] Fix poetry deprecation warnings #​21268
• [Python] Add all variable in the package init.py file for Python APIs #​21185
• [Python] Correct sanitize_for_serialization in python generator for list in oneOf schema elements #​19405

PHP

• Abstract PHP support of "original" for variableNamingConvention #​21336
• [PHP-Symfony] revamp the computation of the contentType #​21292
• [php-laravel generator] update $request->bool to $request->boolean #​21273
• [php-symfony] fix handling of endpoints with "text/plain" or "image/png" response type #​21261
• [php-flight] fix: remove trailing spaces #​21254
• [php-flight] fix: use static PHPUnit assertions #​21253
• fix(php-nextgen): do not call static methods dynamically #​21163

Rust

• [rust-axum] Prevent multiple declarations of the same operation #​21396
• Add model name mapping option to rust generators #​21282
• [rust] support model/maps as deep/explode params #​21262

Ruby

• fix(ruby-client): fix incorrect Date parsing in OneOf #​21364

Scala

• [Scala] Add enums to scala-http4s-server #​21320

TypeScript

• fix(typescript-fetch): use type modifier on imports for discriminator.mappedModels #​21397
• Introduce option 'importFileExtension' to typescript-axios (#​21343) #​21344
• [typescript] add abort signal to requestcontext #​21323
• feat(typescript-angular): add util "provideApi" and update docs to standalone applications #​21173
• fix(typescript-fetch): Use null as a value when the date value is nullable #​21133

v7.13.0: released

Compare Source

v7.13.0 stable release comes with 160+ enhancements, bug fixes, and a new Kotlin Misk server genreator.

Thanks again for all the awesome contributions from the community.

For a full list of changes, please refer to the "Pull Request" tab.

General

• Fixes so that a oneOf schema with a single sub-schema is simplified #​21043
• Make the OpenAPINormalizer extensible #​20995

C#

• [csharp] fix "Simplify 'default' expression (IDE0034)" messages #​21147
• fix: [csharp] JsonConverter anyOf creates uncompilable code #​21137
• Check if enum_values exists in the serverUrl [csharp] #​21122
• [csharp] Process webhook operations #​21082
• [feat][csharp][unity] Add unity 2019 support and update samples #​21036
• [csharp][generichost] Fixed string formatted as decimal #​2089
• Use interfaces for Polly retry policies in C# #​20821
• [csharp] Add useVirtualForHooks option #​20705

C++

• Fix associative container on Json values in UE4cpp #​20606

Crystal

• [crystal-lang] Various fixes for Crystal client #​21045
• [crystal-lang] Various fixes for Crystal client (2) #​21011

Dart

• [dart-dio][timemachine] Bugfix: Ensure closing bracket when adding serializers #​20908
• [dart-dio] Fix the version of the sample dependencies #​20797

Elixir

• [fix][elixir] wrong typespec generation for all-of with single ref #​21139

Go

• [go-server] move errMsg helpers to helpers file #​20876
• fix: Support PathParams not of primitive types for Go in generated tests #​21107
• [go-server] Moved helper code from router and updated logger for chi #​20823

Java

• [fix][java]Add missing generated annotation to Authentication.mustache #​21125
• [jaxrs-cxf-cdi] multipart file upload should only present Attachment #​21124
• [Java] ApiClient: support deserializing from InputStream instead of String to bypass 2GB Java String limit #​21115
• [JAVA][FEIGN] Removing hardcoded HTTP Client which is causing performance issues #​21085
• [Java][Spring] remove 'size', 'page' and 'sort' query params if using 'x-spring-paginated' (#​8315) #​21016
• [JAVA][spring] Make enum fields final in generated Java #​21019
• Added HttpClient5 flavour to Java OpenFeign client generator #​21007
• [java][restclient] Fix model combining properties and additional properties #​20947
• Fix handling of x-implements for enumeration in java and spring generators #​20778

Julia

• [julia] better serverside validation code #​21072
• [julia] fix regex escape on server codegen #​21009

Kotlin

• [kotlin-client][jvm-spring-restclient] Fix metrics URI templating for RestClient #​21149
• [kotlin] [multiplatform] [jvm-ktor] Fix formdata file upload #​21056
• [BUG][kotlin-spring] Fix defaultValue for RequestHeader is not generated #​21003
• Javalin fixes and validation #​20981
• Improving Misk Kotlin Server Generator #​20973
• Add new Misk Kotlin OpenAPI Generator #​2088

nim

• [nim] Fix nim code generation in case of an endpoint for which schema defines both query parameters and multipart/form-data #​20752

OCaml

• Add the dependencies in the generated Opam file #​20805
• Add github workflow for OCaml samples #​20802
• [OCaml] Fix default optional list #​20789
• [OCaml] Add key to each model field #​20766

PHP

• fix(php-nextgen): always return if not void #​21119
• Add error reporting when handling exception in PHP Laravel #​21023
• [PHP] - Add range HTTP code support #​20992
• [PHP] - Add FormDataProcessor to handle nested ModelInterface data #​20990
• [PHP-NEXTGEN] make allowable values enum getter static #​20820
• feat(php): drop support for EOLed PHP versions and unify min required version #​17826

ProtoBuf

• [feat] [protobuf] Improve protobuf generator by adding custom options for api and model files #​21075
• [feat] [protobuf] Improve protobuf generator with switch useSimplifiedEnumNames #​21052
• [Protobuf Schema] Map Field Handling in Composed Schemas #​21002
• [Protobuf Schema] Add Support for Multiple Response #​20989

Postman

• [POSTMAN] Include response examples #​21073

Python

• Fix single quote escaping for python code generator (and its test) #​21021
• [Python] Fix the post processing of string enums #​20976
• fix(fastapi): use correct impl & package vars on custom user values #​20970
• Drop python 3.8 support python 3.13 in python generator #​20909

Rust

• feat: [Rust][client] Add option to use rustls for reqwest instead of openssl #​21001
• [rust] Fix for allOf multi model with only metadata fields #​20892
• [Rust-Axum] Allow use of array query params #​20861

Scala

• [BUG] [scala-sttp] [circe] Generate circe encoder and decoder for inline enumeration #​21028
• Update scala version #​20953
• Update sbt version #​20948
• fix deprecated old sbt build file syntax #​20949

Swift

• [swift][client] make QueryStringEncodable return any Sendable #​21142
• [Swift][client] fix parameters encoding #​20934
• [swift6] Add typed throws to Validation functions #​20903

TypeScript

• Fix typescript-fetch broken files when mixing basic types and refs in oneOf #​21057
• Fixes mapValues runtime inefficiency in typescript-fetch #​21047
• [TypeScript] Avoid warning in TypeScript client generator due to SUPPORTS_ES6 #​21012
• [typescript] Use static middleware when calltime options exist but specify no middleware #​20985
• [typescript-fetch] to fix incorrect parsing with additional properties #​20923